home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-07 / lmail.zip / LANMAIL.DOC < prev    next >
Text File  |  1992-07-11  |  15KB  |  294 lines
  1. Version 1.50C                       LANMail                         07/07/1992
  2.  
  3.    LANMail is a 6K swapping TSR program that allows you to send, receive, and
  4. output LANTastic e-mail.  Also, LANMail provides users with an easy way to
  5. send and respond to pop-up messages.
  6.    As mentioned before LANMail is a swapping TSR which means that when the
  7. hot-key sequence is pressed to activate LANMail, LANMail will swap itself into
  8. memory.  This requires LANMail to store what was previously in memory.  For
  9. this, LANMail will use EMS memory if available, or will create temporary files
  10. on the C: drive (or any other drive as specified by command line parameters.
  11. See RUNNING LANMAIL section below).
  12.  
  13.  
  14. READING MAIL
  15. ============
  16.    When the user selects 'R' from the Net-Mail Services menu, the user will
  17. then be shown the header from the first piece of mail in the mailbox.  This
  18. header contains who the mail is from, the time and date it was sent, and the
  19. subject or comment attached to the message.  If the user wants to read this
  20. message, then he/she should answer 'Y' to "Read this message now [Y,N] ?" Any
  21. other key besides 'Y' will skip to the next message.
  22.  
  23.    After reading the message, the user is presented with the question:
  24.         "<<<End of message>>> (P)rint, (F)orward, (R)eply,
  25.            (D)elete, or (N)ext message ? N "
  26.  
  27.    If the user responds with a 'P', the question
  28.           "Output to (F)ile, (P)rinter, or (N)one ?"
  29.        will appear.  Answering 'F' will allow the user to append toe
  30.        message to the end of a file, or create a new file if necessary.
  31.        Answering 'P' will allow the user to print the message to a
  32.        printer, and answering 'N' will abort the output.  Regardless of
  33.        the response, the message will remain in the user's mailbox.
  34.  
  35.    If the user responds with a 'F' then a free-format message screen will
  36.        appear with the contents of the original message already entered.
  37.        This message can now be edited as any free-form message could be
  38.        (see instructions below).
  39.  
  40.    If the user responds with a 'R' then a blank free-format message screen
  41.        will appear. Unlike a forwarded message, the user cannot select
  42.        which users to send the reply to, only the person who sent the
  43.        message will receive the reply.
  44.  
  45.    If the user responds with a 'D' then the message will be deleted from the
  46.        mailbox.
  47.  
  48.    If the user responds with an 'N' or any other key besides P F R D then the
  49.        next message header will be displayed.
  50.  
  51.  
  52. SENDING MAIL
  53. ============
  54.    LANMail supports the use of a username file for networks that are not using
  55. individual user accounts.  The username file is a text file with the name of
  56. each user on a seperate line.  The file must be in the same directory that
  57. LANMAIL.EXE is in, and should be named LANMAIL.USR.  The file can be created
  58. by any editor that can save files in pure ASCII such as PC-Write, or the
  59. editor included in MS-DOS v5.00.
  60.    LANMail lets the user send mail to the message server in two formats: a
  61. free-form format, and a Phone Message format.
  62.  
  63.  Free-Format
  64.  -----------
  65.    The free-format is for messages not suitable for a Phone Message. Free-form
  66. messages can be sent 3 ways: Selecting 'S' from the Net-Mail Services menu,
  67. Forwarding a message after reading, or Replying to a message after reading.
  68.    When entering in a free-form message, there are a few editing features
  69. available...
  70.        <HOME>    key brings you to the begining of the current line
  71.        <END>     key brings you to the end of the current line
  72.        <INS>     key inserts a space at the cursor location
  73.        <DEL>     key deletes the character under the cursor
  74.        <Ctrl F>  Inserts a file above the current line
  75.        <Ctrl I>  inserts a line above the current line
  76.        <Ctrl Y>  deletes the current line.
  77.        <ESC>     key aborts the message
  78.        <F1>      key saves the message
  79.        Cursor keys are used for moving around the message.
  80.  
  81.    After pressing <F1> to finish entering the free-form message, if you are
  82. replying to a message, you will be prompted for a subject. After entering the
  83. subject, the message will be sent.  If you are forwarding a message, or used
  84. the 'S' selection from the Net-Mail Services menu, then you will be presented
  85. with a list of users. Use the up and down cursor keys to move the highlight
  86. bar, pressing the space bar to toggle a users' name.  A check mark √ will
  87. appear beside the names of the users the message will be sent to. After
  88. selecting the desired users, press <Enter> to finalize your selection, or <ESC>
  89. to abort the message.  After pressing <Enter>, you may then enter a subject.
  90. After the subject is entered, the message will be sent to all the selected
  91. users.
  92.  
  93.  Phone Message
  94.  -------------
  95.    The 'P' selection from the Net-Mail Services menu allows the user to send a
  96. message in the form of a "While you were out" phone message.  The user is
  97. presented with a form that looks similar to the popular paper version of the
  98. phone message. To check the boxes, while in the box you want checked, hit any
  99. letter, to clear the check, press the space bar. Use the up and down cursor
  100. keys to move around to the various fields. (NOTE: The phone number field will
  101. try to automaticly format the number you enter so entering 2055551212 will
  102. give you 205-555-1212 when you leave the field.) Once you are satisfied with
  103. the message, press the <F1> key to send it, or <ESC> to abort. After pressing
  104. <F1> you will be presented with a list, just as you were when sending a free
  105. form message.
  106.    When a phone message is sent, a carbon copy of the message is saved in a
  107. text file called LANMAIL.CRB located in the directory in which LANMail was
  108. executed. This is helpful if you need to look back at phone messages from the
  109. past to find a phone number etc.
  110.  
  111.  
  112. SENDING POP-UP MESSGAES
  113. =======================
  114.    The 'M' selection from the Net-Mail Services menu allows you to send a
  115. pop-up message to any user in the user list.
  116.    After pressing 'M' from the Net-Mail Services menu, you will provided with
  117. a list of users. Use the up and down cursor keys to move the highlight bar,
  118. pressing the space bar to toggle a user name.  A check mark √ will appear
  119. beside the names of the users the pop-up message will be sent to. After
  120. selecting the desired users, press <Enter> to finalize your selection, or
  121. <ESC> to abort the pop-up message.  After pressing <Enter>, you may then enter
  122. a the pop-up message you wish to send. If you press the <Enter> key, the
  123. message will be sent to the selected users, if your press the <ESC> key the
  124. message will be aborted.
  125.  
  126.  
  127. RESPONDING TO POP-UP MESSAGES
  128. =============================
  129.    The 'L' selection from the Net-Mail Services menu allows you to respond to
  130. the last pop-up message received.
  131.    After pressing 'L' from the Net-Mail Services menu, you will see the name
  132. of the machine that sent the last pop-up message, and the contents of the
  133. message.  Now, to send a pop-up message as a response, all you have to do is
  134. type in your message. If you press the <Enter> key, your message will be sent,
  135. or if you press the <ESC> key, the message will be aborted.
  136.  
  137.  
  138. RUNNING LANMAIL
  139. ===============
  140.    LANMail supports the use of a configuration file to contain commonly used
  141. command line options.  The configuration file is a text file with each command
  142. line option (including the / or -) on a seperate line.  The file must be in
  143. the same directory that LANMAIL.EXE is in, and should be named LANMAIL.CFG.
  144. The file can be created by any editor that can save files in pure ASCII such
  145. as PC-Write, or the editor included in MS-DOS v5.00.  Any options used on the
  146. command line override options found in the configuration file.
  147.  
  148.    To run LANMail type:
  149.        LANMAIL /P:{MESSAGE_SERVER} [/S] [/Fpath] [/U] [/K:{Hot-key sequence}]
  150. where {MESSAGE-SERVER} is the name of the server mail and phone messages are
  151. to be sent to.  This parameter must be provided, if it is not, the user will
  152. be prompted to input the phone message server.
  153.  
  154.    The /S parameter can be used to run LANMail in a "stand alone" mode.  This
  155. allows you to run the LANMail program without installing it as a TSR.
  156.    The /F paramter allows you to specify where the 2 swapfiles will be placed.
  157. There is no error checking at this time, so make sure it is a valid location.
  158. (Swap files will only be used if there is not suffecient EMS or extended
  159. memory available for the swap)  If the /F parameter is not used C:\ is
  160. assumed.  An example would be:
  161.        LANMAIL /P:MAIL-SERVER /FD:\TEMP   (Swap files in D:\TEMP)
  162.                     or
  163.        LANMAIL /P:MAIL-SERVER /FD:\       (Swap files in the root of D:)
  164.  
  165.    The /U parameter will attempt to uninstall the LANMail TSR.
  166.  
  167.    The /K parameter allows the user to define a hot key sequence besides the
  168. default sequence of (Alt)(LShift)(~).  An example to set the hot key to
  169. Control Alternate M would be:
  170.        /K:(Ctrl)(Alt)(M)
  171.        (Ctrl)   Control key       (Alt)     Alt key
  172.        (LShift) Left shift key    (RShift)  Right shift key
  173.        (F1)     F1 function key   (F2..F12) Cooresponding function keys
  174.        The letters A-Z, the number 0-9, and all punctuation characters can
  175.        be used.
  176.        NOTE: Only one "main key" can be used.  The main key in the example
  177.                above is the letter M
  178.  
  179.    The /T and /B parameters allow the user to designate text (/T) color and
  180. background (/B) color.  The default colors are White text on a Black
  181. background. Use the following values for the colors:
  182.  
  183.        Black = 0    Red       = 4    DarkGray   = 8     LightRed     = 12
  184.        Blue  = 1    Magenta   = 5    LightBlue  = 9     LightMagenta = 13
  185.        Green = 2    Brown     = 6    LightGreen = 10    Yellow       = 14
  186.        Cyan  = 3    LightGray = 7    LightCyan  = 11    White        = 15
  187.  
  188. For example if you wanted White letters on a Blue background you would use
  189. /T:15 /B:1
  190.  
  191. MISCELLANEOUS INFORMATION
  192. =========================
  193.    LANMail was written using Turbo Power's TSRs Made Easy V1.00 and compiled
  194. under Borland's Turbo Pascal v5.5.  I highly recommend TSR's Made Easy for any
  195. Turbo Pascal programmer wishing to make their programs run as TSRs with
  196. minimal effort and change.  Turbo Power can be reached on CompuServe at user
  197. id 76004,2611 or by phone at (719) 260-6641.
  198.  
  199.  
  200. DISCLAIMER
  201. ==========
  202.    PAUL DURDEN MAKES NO CLAIMS, WRITTEN OR IMPLIED, AS TO THE STABILITY OR
  203. OPERATION OF THIS PROGRAM. USE IT SOLELY AT YOUR OWN RISK! WHILE I BELIEVE
  204. THAT IT PERFORMS ITS INTENDED FUNCTION AS OUTLINED IN THIS DOCUMENT, PAUL
  205. DURDEN WILL NOT BE RESPONSIBLE FOR ANY ADVERSE REACTIONS WHICH MAY BE CAUSED
  206. BY ITS USE.
  207.  
  208.  
  209. REGISTRATION & LEGALITIES
  210. =========================
  211.    LANMail is not freeware, nor is it in the public domain. It is a shareware
  212. program, and the entire program and documentation are Copyright (C) 1992, Paul
  213. Durden, Huntsville, AL. You are encouraged to copy the package freely,
  214. including distribution by BBS, shareware library, or other means, provided
  215. that no fee of more than five US dollars ($5) shall be charged for the copy,
  216. and that the distribution shall consist of the original archive containing the
  217. following files:
  218.    LANMAIL.EXE    The LANMail Mail services program.
  219.    LANMAIL.DOC    This file.
  220.    LANPOP.EXE     The LANPop program.
  221.    LANPOP.DOC     Documentation for the LANPop program.
  222.    REGISTER.DOC   Registration form.
  223.  
  224.    Of course, if you experience a problem using this program, I would like to
  225. know about it. IF YOU USE THIS PROGRAM FOR MORE THAN 15 (FIFTEEN) DAYS, PLEASE
  226. REGISTER IT BY PRINTING AND COMPLETING THE REGISTRATION FORM (REGISTER.DOC),
  227. AND SENDING IT ALONG WITH A CHECK/MONEY ORDER FOR $30 U.S. DOLLARS PAYABLE TO
  228. "Paul Durden" to:
  229.        Paul Durden
  230.        P.O. Box 7234
  231.        Huntsville, AL 35807
  232.  
  233.    The registration covers both the LANMail program and the LANPop program. By
  234. registering, you will receive the most recent release of both the LANMail and
  235. LANPop programs, and will be notified of any future releases.
  236.  
  237.    If you need to contact me for any reason you may reach me at the above
  238. address, or leave e-mail for Paul Durden on Artisoft's ArtiFACTS BBS, or ID
  239. 76360,2306 on CompuServe.
  240.  
  241. VERSION HISTORY
  242. ===============
  243. Version                Changes
  244. --------     ----------------------------------------------------------------
  245.   1.20     *   Initial release to public
  246.  
  247.   1.21     *   Output to printers made less cryptic (hopefully), time-stamp
  248.                problem fixed. Error trapping while reading mail cleaned-up.
  249.  
  250.   1.25     *   Hot-key sequence is now runtime definable.  Text background
  251.                and foreground colors are now initialized to White text on a
  252.                Black background, this hopefully will help monochrome users
  253.                whose cursor disappears while using LANMail due to the
  254.                current programs text attributes.
  255.  
  256.   1.30     *   When selecting users to send a message to, a highlight bar is
  257.                used rather than just the cursor so as to help those with the
  258.                disappearing cursor.
  259.            *   Insert and Delete line capabilities added to the free-format
  260.                message editor.
  261.            *   Added the ability to forward or reply to a message after
  262.                reading it.
  263.  
  264.   1.35     *   Added ability to change text and background color of popup
  265.                screen.
  266.            *   Added the ability to insert a file (<Ctrl F>) into a free
  267.                format message.
  268.            *   Most error messages now require the user to press a key before
  269.                continuing so the error message can be noted for bug reports.
  270.  
  271.   1.40ß    *   LANMail now gets user names from both the MESSAGE_SERVER, but
  272.                also from a text file named LANMAIL.USR located in the same
  273.                directory as LANMAIL.EXE.  The username file consists of one
  274.                username per line, and can be created by any editor than can
  275.                save in pure ASCII such as PC-Write or the editor that comes
  276.                with MS-DOS v5.00.
  277.            *   LANMail also now supports a configuration file named
  278.                LANMAIL.CFG for all command line arguements.  LANMail looks for
  279.                this file in the same directory as LANMAIL.EXE.  The
  280.                configuration file is a text file with one command line option
  281.                per line.  Note: you must still use the / or - just as if you
  282.                were at the command line.
  283.  
  284.   1.48ß    *   LANMail now has the ability to send and respond to pop-up
  285.                messages.
  286.  
  287.   1.50     *   LANMail now supports the TAB key in a free-format message.
  288.            *   Some cosmetic changes to the menus.
  289.            *   LANPop now packaged in archive.
  290.  
  291.   1.50C    *   LANMail now asks for confirmation when aborting a message, or
  292.                when aborting a selection of users.
  293.  
  294.